home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3g / mkdirp.z / mkdirp
Encoding:
Text File  |  2001-04-17  |  5.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. mmmmkkkkddddiiiirrrrpppp((((3333GGGG))))                                                          mmmmkkkkddddiiiirrrrpppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_kkkk_dddd_iiii_rrrr_pppp, _rrrr_mmmm_dddd_iiii_rrrr_pppp - create, remove directories in a path
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _mmmm_kkkk_dddd_iiii_rrrr_pppp _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_p_a_t_h_,,,, _mmmm_oooo_dddd_eeee______tttt _m_o_d_e_))))_;;;;
  17.  
  18.      _iiii_nnnn_tttt _rrrr_mmmm_dddd_iiii_rrrr_pppp _((((_cccc_hhhh_aaaa_rrrr _****_d_,,,, _cccc_hhhh_aaaa_rrrr _****_d_1_))))_;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _mmmm_kkkk_dddd_iiii_rrrr_pppp creates all the missing directories in the given _p_a_t_h with the
  22.      given _m_o_d_e.  [See _cccc_hhhh_mmmm_oooo_dddd(2) for the values of _m_o_d_e.]
  23.  
  24.      _rrrr_mmmm_dddd_iiii_rrrr_pppp removes directories in path _d.  This removal starts at the end of
  25.      the path and moves back toward the root as far as possible.  If an error
  26.      occurs, the remaining path is stored in _d_1.  _rrrr_mmmm_dddd_iiii_rrrr_pppp returns a 0 only if
  27.      it is able to remove every directory in the path.
  28.  
  29. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  30.      _////_**** _cccc_rrrr_eeee_aaaa_tttt_eeee _ssss_cccc_rrrr_aaaa_tttt_cccc_hhhh _dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_iiii_eeee_ssss _****_////
  31.      _iiii_ffff_((((_mmmm_kkkk_dddd_iiii_rrrr_pppp_((((_""""_////_tttt_mmmm_pppp_////_ssss_uuuu_bbbb_1111_////_ssss_uuuu_bbbb_2222_////_ssss_uuuu_bbbb_3333_""""_,,,, _0000_7777_5555_5555_)))) _====_==== _----_1111_)))) _{{{{
  32.           _ffff_pppp_rrrr_iiii_nnnn_tttt_ffff_((((_ssss_tttt_dddd_eeee_rrrr_rrrr_,,,, _""""_cccc_aaaa_nnnn_nnnn_oooo_tttt _cccc_rrrr_eeee_aaaa_tttt_eeee _dddd_iiii_rrrr_eeee_cccc_tttt_oooo_rrrr_yyyy_""""_))))_;;;;
  33.           _eeee_xxxx_iiii_tttt_((((_1111_))))_;;;;
  34.      _}}}}
  35.      _cccc_hhhh_dddd_iiii_rrrr_((((_""""_////_tttt_mmmm_pppp_////_ssss_uuuu_bbbb_1111_////_ssss_uuuu_bbbb_2222_////_ssss_uuuu_bbbb_3333_""""_))))_;;;;
  36.      _....
  37.      _....
  38.      _....
  39.      _////_**** _cccc_llll_eeee_aaaa_nnnn_uuuu_pppp _****_////
  40.      _cccc_hhhh_dddd_iiii_rrrr_((((_""""_////_tttt_mmmm_pppp_""""_))))_;;;;
  41.      _rrrr_mmmm_dddd_iiii_rrrr_pppp_((((_""""_ssss_uuuu_bbbb_1111_////_ssss_uuuu_bbbb_2222_////_ssss_uuuu_bbbb_3333_""""_))))_;;;;
  42.  
  43. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  44.      If a needed directory cannot be created, _mmmm_kkkk_dddd_iiii_rrrr_pppp returns -1 and sets _eeee_rrrr_rrrr_nnnn_oooo
  45.      to one of the _mmmm_kkkk_dddd_iiii_rrrr error numbers.  If all the directories are created,
  46.      or existed to begin with, it returns zero.
  47.  
  48. NNNNOOOOTTTTEEEESSSS
  49.      _mmmm_kkkk_dddd_iiii_rrrr_pppp uses _mmmm_aaaa_llll_llll_oooo_cccc to allocate temporary space for the string.
  50.  
  51.      _rrrr_mmmm_dddd_iiii_rrrr_pppp returns -2 if a ``_....'' or ``_...._....''  is in the path and -3 if an
  52.      attempt is made to remove the current directory.  If an error occurs
  53.      other than one of the above, -1 is returned.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      _mmmm_kkkk_dddd_iiii_rrrr(2), _rrrr_mmmm_dddd_iiii_rrrr(2),
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.